KCSetDefaultKeychain

KCSetDefaultKeychain
Header:	Keychain.h		Carbon status:	Under Evaluation

Sets the default keychain.

OSStatus KCSetDefaultKeychain (
    KCRef keychain
);

keychain: A reference to a keychain that you want to make the default.

function result: A result code. The result code errKCNoSuchKeychain indicates that the specified keychain could not be found. The result code errKCInvalidKeychain indicates that the specified keychain is invalid.

DISCUSSION

The KCSetDefaultKeychain function sets the default keychain to the keychain specified by keychain. If the specified keychain is locked, the user will be prompted to unlock it. Your application should not need to set the default keychain.

VERSION NOTES

Available beginning with Keychain Manager 1.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 2.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 2.0 and later.